DNOSDNCS 

X.25 Remote File Transfer (RFT) 

Object Installation 



Part No. 2302641-9701 *A 
15Decesrbe-1983 



mmi^^iMmm mmmmmmm mm'mmm 






mi 



iiiiiiiiii 
ill 



wornm mmmimmmr 

111 iif ::;;:; iii^ 



i^isfe^^SK-S. 



-:x mi 





Texas Instruments Incorporated 1983 

All Rights Reserved, Printed in U.S.A. 

The information and/or drawings set forth in this document and all rights in and to inventions disclosed 
herein and patents which might be granted thereon disclosing or employing the materials, methods, 
techniques or apparatus described herein, are the exclusive property of Texas Instruments Incorporated. 



Contents 

Title Page 

Section 1 — Introduction 1-1 

Section 2 — Preparing for Installation 2-1 

Section 3 — Executing DNCS X.25 RFT 3-1 



+ + 

i 

READ THIS DOCUMENT BEFORE ATTEMPTING TO USE THE OBJECT KIT. 
THIS DOCUMENT DESCRIBES RELEASE 1.2.0 OP THE DNCS X.25 RPT 
OBJECT INSTALLATION MEDIA, PART NUMBER 2308822-1601 (DISK OR 
TAPE) OR 2308822-1602 (DISKETTE). REFER TO THE RELEASE 
INFORMATION, PART NUMBER 2308859-9901 , FOR ADDITIONAL 
INFORMATION. 

TEXAS INSTRUMENTS ASSUMES NO RESPONSIBILITY FOR MODIFICATIONS 
MADE TO THIS OBJECT KIT. 
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Section 1 
Introduction 



1 . 1 GENERAL INFORMATION 

This document describes the installation of the DNCS X.25 RPT 
object under DNOS. 

Make a backup copy of the released object before executing the 
installation procedures. For copy procedures, refer to the DNOS 
Operations Guide , part number 2270502-9701 . 

Consult the DNOS DNCS X.25 RET Release Information , release 
1.2.0, part number 2308324-9901, for additional information 
concerning the current release. 

This installation document presents many System Command 
Interpreter (SCI) commands in batch format. You can execute 
these commands either by entering the entire command as shown or 
by entering only the command keyword and responding to the 
interactive prompts from SCI. For a discussion of the batch 
command format, refer to the DNOS System Command Interpreter 
(SCI) Reference Manual , part number 2270503-9701. 



1 .2 MEDIA DEFINITION 

Product shipments are "made in the following formats: 

* Disk — A DS10, DS80, DS300, or CD1400 disk containing 
the object 

* Diskette — A double-sided, double-density (DSDD) 
diskette containing the object 

* Magnetic Tape — A cartridge tape or an 800 or 1600 
bits-per-inch (bpi) magnetic tape containing the object 

* Add-On — A disk containing the object and one or more 
other products 
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1.3 INSTALLATION OVERVIEW 

The installation process described in this document provides the 
steps required to prepare the DNCS X.25 RFT object for 
installation. 



1 . 4 SYSTEM REQUIREMENTS 

To perform these installation procedures successfully, you must 
have a DNOS operating system (Release 1.2.0 or later) running on 
a Business System 300, 600, or 800 computer with at least 51 2K 
bytes of memory. 

Consult the DNOS DNCS X.25 RET Release Information , release 
1.2.0, part number 2308324-9901 , for additional information 
concerning memory needed to satisfactorily execute your DNCS 
configuration. 
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Section 2 
Preparing for Installation 



2 . 1 GENERAL 

The DNCS X.25 RET object is shipped on various 
prepared prior to installation. The media must 
disk (if supplied on magnetic tape), copied to 
on diskette), or used directly (if supplied 



section describes how to prepare each type of media 



media and must be 

be restored to 

disk ( if supplied 

on disk). This 



The procedures 
require that 
<dncsvolume> be 
Section 2 of 
Installation. 



NOTE 

outlined in this section 

the DNCS parts volume 

installed as described in 

the DNOS DNCS Nucleus Object 



2.2 DOUBLE-SIDED, DOUBLE-DENSITY (DSDD) DISKETTE FORMAT 

When you receive the object on DSDD diskette, perform the 
following steps: 

1. Enable the write protection for the DNCS X.25 RFT 
object diskette DCRPTO by carefully removing the silver 
sticker from the diskette. 

2. Load the DCRPTO diskette in an available drive and make 
it ready. 

3. Install the diskette volume by using the Install Volume 
(IV) command as follows: 

IV U=<dsxx>, V=DCRFT0 

where : 

<dsxx> is the name of the drive where the diskette is 
loaded . 
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4. Copy the contents of diskette DCRFTO to the DNCS parts 
volume "by using the Copy Directory (CD) command as 
follows: 

CD I=DCRFT0, 0=<dncsvolume>. DCRFTO, L=. LISTING 

where : 

<dncsvolume> is the name of the DNCS parts volume. 

The file .LISTING contains a listing of the directory 
copied from diskette. Check this file for errors by 
using the Show File (SF) or Print File (PF) command. 

5. Unload the diskette volume by using the Unload Volume 
(UV) command as follows: 

UV V=DCRFT0 

6. Remove diskette DCRFTO from the drive. 

7. Assign the synonym DCRFTO to the DNCS X.25 RFT object 
directory by using the Assign Synonym (AS) command as 
follows: 

AS S=DCRFT0, V=<dncsvolume> . DCRFTO 

where : 

<dncsvolume> is the name of the DNCS parts volume. 

8. Proceed to paragraph 2.6 to continue the installation. 



2.3 DISK FORMAT 

When you receive the object on disk, perform the following steps: 

1. Load the DNCS X.25 RFT object disk DCRFTO in an 
available drive and make it ready. Disable the disk 
write protection. 

2. Install the disk volume by using the Install Volume 
(IV) command as follows: 

IV U=<dsxx>, V=DCRFT0 

where : 

<dsxx> is the name of the drive where the disk is 
loaded . 
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3. Copy the contents of disk DCRFTO to the DNCS parts 
volume "by using the Copy Directory (CD) command as 
follows: 

CD I=DCRFT0, 0=<dncsvolume>. DCRFTO, L=. LISTING 

where : 

<dncsvolume> is the name of the DNCS parts volume. 

The file .LISTING contains a listing of the directory 
copied from disk. Check this file for errors by using 
the Show File (SF) or Print File (PF) command. 

4. Unload the disk volume by using the Unload Volume (UV) 
command as follows: 

UV V=DCRFT0 

5. Remove disk DCRFTO from the drive. 

6. Assign the synonym DCRFTO to the DNCS X.25 RFT object 
directory by using the Assign Synonym (AS) command as 
follows: 

AS S=DCRFT0, V=<dncsvolume> .DCRFTO 

where : 

<dncsvolume> is the name of the DNCS parts volume. 

7. Proceed to paragraph 2.6 to continue the installation. 



2.4 MAGNETIC TAPE FORMAT 

When you receive the object on magnetic tape, copy it to a disk 
as follows: 

1. Create the DNCS X.25 RFT object directory on the DNCS 
parts volume by using the Create Directory File (CFDIR) 
command as follows: 

CFDIR P=<dncsvolume>. DCRFTO, M=50 

where : 

<dncsvolume> is the name of the DNCS parts volume. 
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2. Assign the synonym DCRFTO to the DNCS X.25 RFT object 
directory by using the Assign Synonym (AS) command as 
follows: 

AS S=DCRFT0, V=<dncsvolume>. DCRFTO 

where : 

<dncsvolume> is the name of the DNCS parts volume. 

3- Enable the magnetic tape write protection. Then mount 
the tape on an available tape drive and make it ready. 

4. Copy the contents of the tape to the DNCS X.25 RFT 
object directory by using the Restore Directory (RD) 
command as follows: 

RD S=<mtxx>, D=DCRFT0, 1= . LISTING 

where : 

<mtxx> is the name of the drive where the tape is 
mounted . 

The file .LISTING- contains a listing of the directory 
restored from magnetic tape. Check this file for 
errors by using the Show File (SF) or Print File (PF) 
command . 

5. Unload the tape. 

6. Proceed to paragraph 2.6 to continue the installation. 
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2.5 ADD-ON FORMAT 

When you receive the object as an add-on, perform the steps in 
either paragraph 2.5*1, 2.5*2, or 2.5*3 depending on whether the 
add-on is received on the DNOS system disk, on a secondary disk 
with the DNCS nucleus, or on a secondary disk without the DNCS 
nucleus . 



2.5*1 DNOS System Disk Add-On 

If you receive the DNCS X.25 RPT object add-on on the DNOS system 
disk and the system is running under that disk, perform the 
following steps: 

1. Assign the synonym DCRPTO to the DNCS X.25 RPT object 
directory by using the Assign Synonym (AS) command as 
follows: 

AS S=DCRPT0, V=. DCRPTO 

2. Proceed to paragraph 2.6 to continue the installation. 



2.5.2 Secondary Disk Add-On with DNCS Nucleus 

If you receive the DNCS X.25 RPT object add-on on a secondary 
disk that includes the DNCS nucleus object, perform the following 
steps : 

1. Assign the synonym DCRPTO to the DNCS X.25 RPT object 
directory by using the Assign Synonym (AS) command as 
follows: 

AS S=DCRPT0, V=<dncsvolume>. DCRPTO 

where : 

<dncsvolume> is the name of the DNCS parts volume. 

2. Proceed to paragraph 2.6 to continue the installation. 
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2.5.3 Secondary Disk Add-On Without DNCS Nucleus 

If you receive the DNCS X.25 RFT object add-on on a secondary 
disk that does not include the DNCS nucleus object, perform the 
following steps: 

1 . Load the disk in an available drive and make it ready. 
Disable the disk write protection. 

2. Install the disk volume by using the Install Volume 
(IV) command as follows: 

IV U=<dsxx>, V=<addvolume> 

where : 

<dsxx> is the name of the drive where the disk 
is loaded. 

<addvolume> is the volume name of the add-on disk. 

3. Copy the DNCS X.25 RFT object to the DNCS parts volume 
by using the Copy Directory (CD) command as follows: 

CD I=<addvolume>.DCRFTO, 0=<dncsvolume>.DCRFTO, 
L=.LISTING- 

where : 

<addvolume> is the volume name of the add-on disk. 

<dncsvolume> is the name of the DNCS parts volume. 

The file .LISTING contains a listing of the directory 
copied from disk. Check this file for errors by using 
the Show Pile (SF) or Print Pile (PP) command. 

4. Unload the add-on disk volume by using the Unload 
Volume (UV) command as follows: 

UV V=<addvolume> 

where : 

<addvolume> is the volume name of the add-on disk. 
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5. Remove the add-on disk from the drive. 

6. Assign the synonym DCRFTO to the DNCS X.25 RPT object 
directory by using the Assign Synonym (AS) command as 
follows: 

AS S=DCRFT0, V=<dncsvolume>. DCRPTO 

where : 

<dncsvolume> is the name of the DNCS parts volume. 

7- Proceed to paragraph 2.6 to continue the installation. 



2.6 INSTALLATION COMPLETION 

Proceed to paragraph 2.6 of the DNOS DNCS Nucleus Object 
Installation to continue the DNCS X.25 RPT object installation. 

After completing the installation, including starting the DNCS 
nucleus job, proceed to the next section for instructions on how 
to start and stop the DNCS X.25 RPT job. 
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Executing DNCS X.25 RFT 



3 . 1 GENERAL 

The procedures in this section describe how to start and stop the 
DNCS X.25 RFT job. The contents of DCRFTEG, the program 
interface examples directory, is also described. For a complete 
description of all X.25 RET commands and their functions, refer 
to the DNOS DNCS X.25 Remote File Transfer (RFT) User's Guide , 
part number 2302640-9701 . 



3-2 CHECKING DNCS NUCLEUS 

Before attempting to start the DNCS X.25 RFT job, verify that the 
DNCS nucleus has been successfully started by using the Show DNCS 
Log File (DNCSLOG) command as follows: 

[J DNCSLOG 

The DNCSLOG command displays the newly" initialized DNCS log file 
when DNCS has been started successfully. 



3-3 EXECUTING THE DNCS X.25 RFT JOB 

Perform the following steps to execute the DNCS X.25 RFT job: 

1. Start the local RFT job by using the Execute RFT (XRFT) 
command as follows: 

LJ XRFT 

EXECUTE RFT 

RFT LOG NAME: .S$DNCS .RFTLOG 

RFT LOG NAME 

Enter a pathname that specifies the RFT log file. 
The default value is .RFTLOG. 
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The DNCS X.25 RFT job takes about one minute to start- 
up. You can check it for readiness by using the Show 
RFT Log File (RFTLOG) command as follows: 

[J RFTLOG 

The RFTLOG command displays the newly initialized RFT 
log file when DNCS X.25 RFT is operational. 



3-4 TERMINATING THE DNCS X.25 RFT JOB 

To terminate the DNCS X.25 RFT job, enter the Terminate RFT 
(TRFT) command as follows: 

[J TRFT 

TERMINATE RFT 

ABORT ALL TRANSFERS (Y/N) : NO 

ABORT ALL TRANSFERS (Y/N) 

Enter the default value NO to allow all file transfers to 
complete before system shutdown occurs. Enter Y only to 
abort all transfers. 



3.5 RFT USER PROGRAM EXAMPLES 

The DCRFTO object installation disk contains a directory DCRFTEG 
that provides a complete set of examples for using the DNCS X.25 
RFT user program interface. By using this interface, user 
application programs written in Pascal, COBOL, or assembly 
language can initiate remote file transfers and send operator 
messages. (Refer to the DNOS DNCS X.25 Remote File Transfer 
(RFT) User's Guide, part number 2302640-9701 . ) 
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The contents of DCRFTEG are as follows: 

DCRFTEG.SRC 

This directory contains complete source code programs ready 
for compilation/assembly: 

TMSASY (Messages assembly language program) 

TMSCOB (Messages COBOL program) 

TMSPSC (Messages Pascal program) 

TCPASY (Copy File assembly language program) 

TCPCOB (Copy File COBOL program) 

TCPFSC (Copy File Pascal program) 

DCRFTEG. LNK 

This directory contains link control files for the programs 
in DCRFTEG.SRC to link in the required RFT run-time modules 
(from the DNCS generation subdirectory .S$DGU$.RFTOBJ or the 
disk DCRFTO): 

TMSASY (Messages assembly language program) 

TMSCOB (Messages COBOL program) 

TMSPSC (Messages Pascal program) 

TCPASY (Copy File assembly language program) 

TCPCOB (Copy File COBOL program) 

TCPPSC (Copy File Pascal program) 

DCRFTEG.PROC 

This directory contains a complete set of SCI procedures 
that you can use to execute the desired program: 

SMSGASY (Messages assembly language program) 

SMSGCOB (Messages COBOL program) 

SMSGPSC (Messages Pascal program) 

CPYFASY (Copy File assembly language program) 

CPYFCOB (Copy File COBOL program) 

CPYFPSC (Copy File Pascal program) 

DCRFTEG.PGF 

This program file contains the installed tasks: 

TMSASY (Messages assembly language task) 

TMSCOB (Messages COBOL task) 

TMSPSC (Messages Pascal task) 

TCPASY (Copy File assembly language task) 

TCPCOB (Copy File COBOL task) 

TCPPSC (Copy File Pascal task) 

The DCRFTEG directory is for your DNCS X.25 RFT applications 
programmer. It is ready for use whenever the DNCS X.25 RFT job 
is active. 
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